home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / u_man / cat1 / bstream.z / bstream
Encoding:
Text File  |  2001-04-17  |  5.7 KB  |  133 lines
  1.  
  2.  
  3.  
  4. bbbbssssttttrrrreeeeaaaammmm((((1111))))                                                          bbbbssssttttrrrreeeeaaaammmm((((1111))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      bstream - many buffered filter
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      bbbbssssttttrrrreeeeaaaammmm [----nnnn bufs] [----bbbb size] [----llllttttrrrrvvvvdddd] [----ssss count] [----iiii file] [----oooo file]
  13.  
  14. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  15.      This command is a filter which buffers input from the input file and
  16.      writes it to the output file.  The command is especially useful for
  17.      reading from or writing to streaming tape drives, where bstream can be
  18.      used as a speed matching program to keep the tape streaming as much as
  19.      possible.
  20.  
  21.      If input or output files are not specified, then _b_s_t_r_e_a_m simply copies
  22.      the standard input to the standard output through multiple buffers.  A
  23.      tape can be written to or read from in this manner, but _b_s_t_r_e_a_m will not
  24.      be able to handle multiple tape copies.  If multiple tapes are involved,
  25.      explicitly specifying the tape device via the ----iiii or ----oooo options will
  26.      enable _b_s_t_r_e_a_m to recover from end of medium indications and request a
  27.      new tape.
  28.  
  29. OOOOPPPPTTTTIIIIOOOONNNNSSSS
  30.      The following options are supported:
  31.  
  32.      ----bbbb _s_i_z_e   specifies the size (in 1024-byte units) of buffer to use.  The
  33.                default size is 64K bytes, however any size up to the maximum
  34.                allowable shared memory segment size for the system is allowed.
  35.  
  36.      ----nnnn _c_n_t    Sets the number of buffers to use.  More than two buffers can
  37.                improve performance and make the tape more likely to stream.  A
  38.                minimum of two and a maximum of six is enforced.  The default
  39.                value is set to four.
  40.  
  41.      ----llll        Attempt to lock the shared memory buffers into physical memory.
  42.                This will not be possible unless the command is run by the
  43.                superuser.
  44.  
  45.      ----tttt        Attempt to lock program image and stack in physical memory.
  46.                This will not be possible unless the command is run by the
  47.                super user.  The nice value of the _b_s_t_r_e_a_m process is also
  48.                decreased, increasing its scheduling priority.
  49.  
  50.      ----rrrr        Report a summary of the byte throughput achieved by _b_s_t_r_e_a_m for
  51.                the entire transfer as well as for each individual tape if
  52.                multiple tapes are involved.
  53.  
  54.      ----vvvv        Reports each i/o that is done (very verbose).
  55.  
  56.      ----dddd        Reports very verbose debugging information.
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. bbbbssssttttrrrreeeeaaaammmm((((1111))))                                                          bbbbssssttttrrrreeeeaaaammmm((((1111))))
  71.  
  72.  
  73.  
  74.      ----ssss _c_o_u_n_t  Report a summary of the byte throughput achieved by _b_s_t_r_e_a_m
  75.                every _c_o_u_n_t buffers, for both input and output.
  76.  
  77.      ----iiii _f_i_l_e   Specify the input file as an explicit filename, allowing
  78.                recovery from end-of-medium conditions on tapes.  The user will
  79.                be prompted for a new tape.
  80.  
  81.      ----oooo _f_i_l_e   Specify the output file as an explicit filename, allowing
  82.                recovery from end-of-medium conditions on tapes.  The user will
  83.                be prompted for a new tape.
  84.  
  85.      To copy a filesystem onto multiple tapes:
  86.  
  87.           ttttaaaarrrr ccccffff ---- **** |||| bbbbssssttttrrrreeeeaaaammmm ----oooo////ddddeeeevvvv////ttttaaaappppeeee
  88.  
  89.      Recovering an image from tape is just as easy:
  90.  
  91.           bbbbssssttttrrrreeeeaaaammmm ----iiii////ddddeeeevvvv////ttttaaaappppeeee |||| ttttaaaarrrr xxxxffff ----
  92.  
  93.  
  94.      There is a subtle issue involving tapes that should be understood when
  95.      using _b_s_t_r_e_a_m with a tape device.  Usually, a tape device requires that
  96.      the tape be written in even multiples of the block size.  When _b_s_t_r_e_a_m is
  97.      used as a streaming filter (see the above examples) this is not a
  98.      problem, since both _t_a_r(_1) and _c_p_i_o(_1) block the output on natural tape
  99.      boundaries.  To protect the user, _b_s_t_r_e_a_m will round the final write to
  100.      tape up to the nearest tape blocksize boundary, fill the residual of the
  101.      last block with zeros, and print a warning message if rounding up was
  102.      needed.  _b_s_t_r_e_a_m should always be used with a formatter program such as
  103.      _t_a_r or _c_p_i_o when writing to a tape device, since rounding up and filling
  104.      may have unpredictable effects on programs expecting a simple byte
  105.      stream.  No rounding or filling is done when output is not directed to a
  106.      tape device.
  107.  
  108. NNNNOOOOTTTTEEEESSSS
  109.      _b_s_t_r_e_a_m runs only on Silicon Graphics 4D series workstations.  On an
  110.      unloaded 4D60, _b_s_t_r_e_a_m can stream the tape 70 to 80% of the time,
  111.      achieving byte transfer rates around 70K bytes per second.
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.